home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / smile13.zip / SMILE13.DOC < prev    next >
Text File  |  1990-11-18  |  14KB  |  297 lines
  1.  
  2.   SM][LE   version  1.3  .....Copyright (c) 1990..... by: Michael Arnett
  3.  
  4.  
  5.   SM][LE is a graphics display utility which allows the user to view
  6.   files containing ANSI codes.  An ANSI Driver is required.  Check your
  7.   CONFIG.SYS file for the following entry:
  8.  
  9.   DEVICE=<drive>:\<path>\ANSI.SYS  (ie. DEVICE=C:\DOS\ANSI.SYS)
  10.  
  11.   If an ANSI driver is not present, screens are displayed as text files.
  12.   This program was born from the need for a utility to view ANSI files
  13.   collected in the GT Network's International ANSI/ASCII Art Echo, from
  14.   the DOS environment.  Several good programs existed for this purpose but
  15.   none contained all the features I was looking for.  SMILE builds and
  16.   maintains a list of user selectable screens in a file named FILELST.DAT
  17.   for each Directory selected.  This allows the user to add Artist names
  18.   and/or comments to each File Name using SMILE's built in Edit features.
  19.   A text editor may also be used to edit FILELST.DAT.  Line length for File
  20.   Name and Artist should be sixty characters or less.  The "│" delimiter
  21.   should not be moved or altered when editing.  A File Name list allows a
  22.   collection of ANSI graphics to be distributed or maintained with artist
  23.   and file information. 
  24.  
  25.   The ability to interpret music codes was another requirement for this
  26.   utility.  Many communication packages do not support music from a BBS, and
  27.   neither DOS nor the ANSI driver have any idea what to do with music codes. 
  28.   Music should be written in the BASIC Play format.  Unusual results may
  29.   occur if this format is not used.
  30.  
  31. GETTING STARTED:
  32.  
  33.   The program is looks for files ending in  .ANS by default.  When SMILE
  34.   loads, it checks for the existence of FILELST.DAT.  If it does not exist,
  35.   SMILE builds a list of all files in the current directory that match
  36.   the *.ANS file mask.  Otherwise, SMILE displays the information in the
  37.   FILELST.DAT file.
  38.  
  39.   To load, enter SMILE at the DOS prompt. 
  40.  
  41.   COMMAND LINE SWITCHES  (optional)
  42.  
  43.   /D     - will instruct SMILE to delete any FILELST.DAT files
  44.            in the directories it visits.
  45.  
  46.            EX.  SMILE /D
  47.  
  48.            Each directory visited by SMILE will contain it's own FILELST.DAT
  49.            file.  You may instruct SMILE to delete these files when exiting
  50.            the program or changing directories by using /D on the command line.
  51.  
  52.    /A:   - should be followed by the DRIVE, PATH and complete FILE NAME
  53.            of the ANSI editor of your choice.  The HIGHLIGHTED file name
  54.            is passed to the editor by pressing ALT-A.  
  55.  
  56.            EX.  SMILE /A:C:\DRAW\THEDRAW.EXE
  57.  
  58.    /E:   - should be followed by the DRIVE, PATH and complete FILE NAME
  59.            of the TEXT editor of your choice.  The HIGHLIGHTED file name
  60.            is passed to the editor by pressing ALT-E.
  61.  
  62.            EX.  SMILE /E:C:\UTIL\QEDIT.EXE
  63.  
  64.     All or any combination of these switches may be used on the Command Line.  
  65.     They need not be in any particular order.  
  66.  
  67.  
  68.  
  69. VIEWING FILES:
  70.  
  71.   The main screen consists of several KEY COMMANDS and a display of the first
  72.   ten files in FILELST.DAT.  You may scroll through all the files using any
  73.   of the direction keys including:
  74.  
  75.        All cursor keys (Up, Down, Right, Left), PgUp, PgDn, Home and End. 
  76.  
  77.   The program will pause at the end of each screen display.  Press ANY KEY to
  78.   continue.  SMILE will also pause during a screen display if CTRL-E is the
  79.   first character of a line.  You will see the word "PAUSE" at the bottom
  80.   left of the screen.  Press any key to continue the display or F10 to abort.
  81.   This option was added to conform to the way GT Power displays files. 
  82.  
  83. KEY COMMANDS:
  84.  
  85.   Pressing ENTER will display only the file that is Highlighted.  
  86.  
  87.   +/-  -  Increments the System Delay time between one and ten seconds. 
  88.           This Delay time can be utilized when viewing TAGGED files. 
  89.  
  90.   S    -  Toggles the Display SPEED between FAST and SLOW.  Animated
  91.           screens usually display a little better at SLOW speed.
  92.  
  93.   O    -  Sorts displayed list by either SCREEN or ARTIST information.
  94.  
  95.   ALT-S   Prompts for a 12 character Search String.  Each line of the
  96.           displayed information is searched for a match of the characters
  97.           you enter.  Accuracy of the search increases with more characters.
  98.           For example, entering "a" will find the first line of text that
  99.           contains an "a" anywhere in the text.  The search is NOT case 
  100.           sensitive.  The highlight bar moves to the first "matched" record.
  101.  
  102.   INS  -  will TAG or UNTAG the currently Highlighted file.  This allows
  103.           you to select several of the File Names listed.  Files remain
  104.           TAGGED even if they scroll out of the selection window.  Files
  105.           are TAGGED with the current Display Speed.  Either an "F" (FAST)
  106.           or "S" (SLOW) is displayed to the left of the file name.  By
  107.           Toggling the Display Speed it is possible  to TAG files for both
  108.           FAST and SLOW speeds.                                    
  109.  
  110.   F1 - Displays HELP screens for each COMMAND KEY. 
  111.  
  112.   F2 - TAGs or UNTAGs every file that matches your selection, (All, Unviewed
  113.        Define or Viewed) including those not visible in the selection window.
  114.        The DEFINE option prompts for a search string (SEE ALT-S).  This would
  115.        allow tagging by Artist.  You could, for example, select all Animated
  116.        screens if you enter something like "(A)" in their description and then 
  117.        Define "(A)".  All files are TAGGED with the current Display Speed.  
  118.        Either an "F" (FAST) or an "S" (SLOW) is displayed to the left of each
  119.        file name.
  120.  
  121.   F3 - Begins displaying each TAGGED file. You will be prompted for
  122.        Continuous View (Y/N).  Answering "Y" causes SMILE to use the System
  123.        Delay time between each screen and anywhere CTRL-E is the first
  124.        character of a line in the file.  Answering "N" causes SMILE to wait
  125.        for a key press between each screen and where CTRL-E is the first
  126.        character of a line.  When viewing TAGGED files, a box with Artist name
  127.        and comments will appear prior to each screen.
  128.  
  129.   F4 - Toggles Music ON or OFF.  This determines whether or not you hear
  130.        music if it is contained in the displayed file. 
  131.  
  132.   F5 - Turns Edit Mode on and allows editing the artist name and comment
  133.        information.  HELP is available in Edit Mode by pressing F1.  
  134.  
  135.        Edit keys:
  136.  
  137.        ENTER  = Exit and Save
  138.        ESC    = Abort changes and re-display original text
  139.        CTRL-Y = Erase entire line of text
  140.        CTRL-K = Erase from the cursor to end of line
  141.        INS    = Toggles Insert mode (Large cursor indicates Insert is ON)
  142.        DEL    = Delete character to right of cursor
  143.        BACKSPACE = Delete character to left of cursor
  144.  
  145.        Cursor movement keys:
  146.  
  147.        RIGHT ARROW, LEFT ARROW, HOME, END
  148.        CTRL-RIGHT ARROW = Move cursor right one word
  149.        CTRL-LEFT ARROW  = Move cursor left one word
  150.  
  151.   F6 - Rebuild File List
  152.  
  153.        Deletes the File Name List in the current directory.  The list is
  154.        then rebuilt and sorted alphabetically using the currently selected
  155.        File Mask.  
  156.  
  157.        WARNING:
  158.        *** If you have added Artist names or comments to the FILELST.DAT ***
  159.        *** file this option will erase them.                             ***
  160.  
  161.   F7 - Update File List
  162.  
  163.        Updates and sorts alphabetically, the File Name List with new files
  164.        that match the current File Mask.  Existing artist\comment information
  165.        in the File name list is retained.  File names that have been erased
  166.        from the directory are deleted from the list. If you see the message:
  167.        "FILE NOT FOUND - UPDATE FILE LIST"
  168.        select this option to refresh the file name list. 
  169.        You may also use a text editor to delete file names from FILELST.DAT
  170.        that are not needed or no longer exist. 
  171.  
  172.   F8 - Edit File Mask
  173.  
  174.        This option allows you to change the current File Mask.  At the prompt
  175.        you may enter any DOS compatible File Name or wild card. 
  176.  
  177.        EX.  *.*,  *.ANS,  *.MSG,  ???.*,  ECHO.ANS
  178.  
  179.        If you change the File Mask you will be prompted to REBUILD or UPDATE
  180.        the current File Name List.  UPDATE will add files with the new file
  181.        mask to the existing list.  This allows you to have multiple file types
  182.        on the same File Name List.  If you select REBUILD, the current File
  183.        Name List is deleted then Rebuilt using the new File Mask.  This option
  184.        deletes any existing Artist Name or comment information.  If you leave
  185.        the prompt blank, the File Mask will be changed but no File List
  186.        changes are made. 
  187.  
  188.   F9 - Change Drive\Directory
  189.  
  190.        This option prompts for a new Drive designation and Directory.  Current
  191.        designations are maintained if you press ENTER at either prompt without
  192.        entering new information.   
  193.  
  194.        To change Disk Drives enter only the letter designation for that drive. 
  195.        To change to Drive A: enter only the letter A.  
  196.  
  197.        If the Drive designation is changed and the directory prompt is left
  198.        blank, SMILE will automatically change to the current Directory on that
  199.        drive.  If FILELST.DAT does not exist it is built using the current File
  200.        Mask. 
  201.  
  202.        To change Directories enter any valid DOS directory. For example:
  203.  
  204.        \ANSI
  205.        \ANSI\PICS
  206.        \ANSI\PICS\NEW
  207.  
  208.        A warning message is given for an Invalid Directory and you will be
  209.        prompted to re-enter the Directory information.  If you change
  210.        Directories, SMILE automatically looks for FILELST.DAT.  If found, you
  211.        are prompted to overwrite the file with current File Mask information. 
  212.        If FILELST.DAT does not exist, it is built using current information. 
  213.  
  214.   F10  QUIT the program
  215.  
  216.        ( NOTE: During file display this key will abort the display and )
  217.        ( return you to the File Selection screen.                      )
  218.  
  219. DISCLAIMER:
  220.  
  221.     This program has been successfully tested on a variety of different PCs. 
  222.     However, problems could appear on machines with different configurations. 
  223.     Use of this program is at your own risk. 
  224.  
  225. COMMENTS:
  226.  
  227.     SMILE 1.3  was written in Microsoft's QuickBasic 4.5
  228.  
  229.     Any comments or suggestions would be appreciated. 
  230.  
  231.     GT Power is a product of P&M Software
  232.  
  233. HISTORY:
  234.  
  235.        Release
  236.  
  237.        1.2 Allow call to ANSI Editor via ALT-A (command line parameter /A:)
  238.        1.2 Allow call to TEXT Editor via ALT-E (command line parameter /E:)
  239.        1.2 Added FAST or SLOW display speeds  (Toggle with ALT-S)
  240.        1.2 Show Record number of Total records
  241.        1.2 INS Tags current display speed & moves cursor down one record
  242.        1.2 Tag Files with either Fast or Slow display
  243.  
  244.        1.3 Sort Routines for Screen or Artist info
  245.        1.3 Names of VIEWed screens are displayed in Green
  246.        1.3 Search listings for user defined text
  247.        1.3 Tag ALL, Unviewed, Viewed, or Defined files
  248.  
  249.     -----------------------------* * * * * * *----------------------------
  250.  
  251.      Members of THE GAVEL BBS, a private BBS sponsoring the GT International
  252.      ANSI/ASCII Art Conference, are now collecting new and used computer
  253.      hardware, software and cash for donation to area hospitals for the
  254.      benefit of hospitalized children.  This non-profit effort has come
  255.      to be known as THE SMILING KIDS project.
  256.  
  257.      The spectacular ANSI artwork collected at THE GAVEL was the driving
  258.      force behind the writing of the SMILE graphics display program and
  259.      much of this fantastic art is included with this offer.
  260.  
  261.      Please consider a donation of $10.00 to this worthy project.
  262.      All contributors will receive a registered version of this program.
  263.      The following ANSI graphics collections from The Gavel's outstanding
  264.      International ANSI\ASCII Art Echo will also be provided to each donor:
  265.  
  266.      "Best of the ANSI Art Echo - 1989" - 209 of the best ANSI graphics
  267.                                           collected during 1989.
  268.  
  269.      "BBS ADS and HOLIDAY ART"          - 77 BBS ADS from around the world
  270.                                           and 46 assorted Holiday graphics.
  271.  
  272.      Each disk comes with a completed FILELST.DAT file for use with SMILE.
  273.  
  274.      If you find the program useful (and even if you don't), please consider
  275.      donating your spare hardware, software, money or time to this fine
  276.      project.  These kids can use your help.
  277.  
  278.      For more information on how to MAKE A KID SMILE, contact:
  279.  
  280.                                Ernest O. DeBakey
  281.                                       or
  282.                                 Michael Arnett
  283.  
  284.                                  THE GAVEL BBS
  285.                         GT Netmail - Net Node  001/030
  286.                  GT International ANSI/ASCII Art Echo  E10/037
  287.  
  288.                                Mailing Address:
  289.  
  290.                                MAKE A KID SMILE
  291.                         c/o  Ernest O. DeBakey, Trustee
  292.                          The Bechtel Tower, Suite 1480
  293.                             3000 Post Oak Boulevard
  294.                            Houston, Tx   77056-6582
  295.  
  296.      ------------------------------* * * * * * *-----------------------------
  297.